home *** CD-ROM | disk | FTP | other *** search
/ Joint Education Initiative / Joint Education Initiative.iso / dos / user_doc / idrisi.doc < prev    next >
Text File  |  1990-06-26  |  14KB  |  352 lines
  1.  
  2.  
  3.  
  4.        10. ERROR MESSAGES
  5.  
  6.  
  7.  
  8.        Most  IDRISI modules generate module-specific error messages when 
  9.        responses  lead  to  conditions  that  are  unworkable,  or  when 
  10.        unexpected results may be generated.  The MODULE DESCRIPTIONS
  11.        section  lists  these at the bottom of  each  module  description 
  12.        sheet. If an error message occurs during the running of a module, 
  13.        first  check the specific module sheet.   If the error message is 
  14.        not  described there,  then the message has been generated  by  a 
  15.        general  set of routines (typically involved with input / output) 
  16.        that all IDRISI modules share.   These general error messages are 
  17.        listed here,  along with a discussion of the cause or solution if 
  18.        it is not obvious.  Entries in square brackets indicate parts  of 
  19.        the message that will vary depending upon the circumstance,  with 
  20.        the entry indicating the nature of what will appear.
  21.  
  22.        10.1 Data Entry Errors
  23.  
  24.        1. Please enter a number between 1 and [another number].
  25.  
  26.           -    either your response to a menu was not understood, or 
  27.                the value you have entered is not permissible (e.g., 
  28.                you have entered a real number when an integer is
  29.                required).  Enter an integer value within the range
  30.                indicated.
  31.  
  32.        2. Numeric value input is incorrectly formatted or out of range.
  33.  
  34.           -    this message will most probably appear in instances 
  35.                where an integer number is required, and a real number 
  36.                was entered.  However, any non-numeric entry will 
  37.                generate this result when a number is required. 
  38.                Similarly, entering a value greater than 32767 or less 
  39.                than -32768 when an integer is required will result in 
  40.                this error.  Similarly, byte values must fall within 
  41.                the range of positive 0 - 255.
  42.  
  43.        3. Illegal character in name.
  44.  
  45.           -    an illegal character has been used as part of an image   
  46.                name.  If in doubt, use an alphabetic character for the  
  47.                first letter and either alphabetic characters or numerals 
  48.                for all remaining characters.
  49.  
  50.        4. Image name is too long (max = 8 characters).
  51.  
  52.           -    Image names are restricted to 8 characters or less. In 
  53.                some rare instances, this message may appear for non-
  54.                image file names. The interpretation, however, is
  55.                identical.è
  56.  
  57.  
  58.                                        1
  59.  
  60.  
  61.        5. File extensions not allowed.
  62.  
  63.           -    Although IDRISI data files are stored with specific      
  64.                extensions (eg., .IMG for image files), you should not 
  65.                use them when referring to data sets. Thus, for example,
  66.                an image stored as SOILS.IMG would be referred to by the 
  67.                simple name SOILS (without the .IMG).
  68.  
  69.        6. Please enter a name up to 8 characters in length.
  70.  
  71.           -    You pressed return without specifying an image or 
  72.                file name.
  73.  
  74.        7. No on-line help. See IDRISI manual.
  75.  
  76.           -    A request for help was made when input of an image name 
  77.                was required.  See the MODULE DESCRIPTION sheet for the
  78.                module you were using -- it lists complete instructions
  79.                for that module. If you are unfamiliar with any of the
  80.                terminology, see BASIC CONCEPTS and GETTING STARTED.
  81.  
  82.  
  83.  
  84.        10.2 Data File Access Errors
  85.  
  86.  
  87.        8.  IDRISI  documentation file for [file name] does not exist  on 
  88.        [drive and path name].
  89.  
  90.           -    a data file was found, but not its documentation file. 
  91.                Use the DIR operating system command to confirm its
  92.                existence.  If it appears in the directory, run ENVIRON 
  93.                to be sure that the documentation file extension is the
  94.                same as that attached to the documentation file in
  95.                question.  If it does not exist, run DOCUMENT to create
  96.                one.
  97.  
  98.        9.  IDRISI  image file for [image name] does not exist on  [drive 
  99.        and path name].
  100.  
  101.           -    a documentation file was found, but not its image file. 
  102.                Use the DIR operating system command to confirm its
  103.                existence.  If it appears in the directory, run ENVIRON 
  104.                to be sure that the image file extension listed is the 
  105.                same as that attached to the image file in question.
  106.  
  107.  
  108.        10.  Image  file  [file name] does not exist on [drive  and  path 
  109.        name].
  110.  
  111.           -    neither the image file nor its documentation file were
  112.                found. Check that the drive and path are correctly
  113.                identified. If not, change them with the ENVIRON module.è
  114.                Otherwise, use the DIR operating system command to 
  115.                confirm its existence, and check your spelling.
  116.  
  117.  
  118.                                        2
  119.  
  120.  
  121.        11.  Vector  file  [file name] does not exist on [drive and  path 
  122.        name].
  123.  
  124.           -    neither the vector file nor its documentation file were
  125.                found.  Check that the drive and path are correctly
  126.                identified. If not, change them with the ENVIRON module.
  127.                Otherwise, use the DIR operating system command to 
  128.                confirm its existence, and check your spelling.
  129.  
  130.        12.  Attribute  values file [file name] does not exist on  [drive 
  131.        and path name].
  132.  
  133.           -    neither the attribute values file nor its documentation
  134.                file were found. Check that the drive and path are
  135.                correctly identified. If not, change them with the 
  136.                ENVIRON module.  Otherwise, use the DIR operating system
  137.                command to confirm its existence, and check your 
  138.                spelling.
  139.  
  140.        13. IDRISI vector file missing.
  141.  
  142.           -    The vector file indicated could not be found. Check the
  143.                spelling.  Also, make sure that the vector file's 
  144.                extension is the same as that indicated in the environ-
  145.                ment file.
  146.  
  147.        14. IDRISI attribute values file missing.
  148.  
  149.           -    The attribute file indicated could not be found. Check 
  150.                the spelling. Also, make sure that the values file's
  151.                extension is the same as that indicated in the environ-
  152.                ment file.
  153.  
  154.        15. Access attempted to non-existent data file.
  155.  
  156.           -    An unspecific error message that indicates that the data
  157.                file required could not be found.  This message is 
  158.                unlikely to occur very often, but would most probably be
  159.                associated with trying to access a non-image file.  For
  160.                example, a font file not found by DISPLAY would generate
  161.                this message.
  162.  
  163.  
  164.        10.3 Data File Format Errors
  165.  
  166.  
  167.        16. Unexpected end of file.
  168.  
  169.           -    more data were expected that were actually present in the
  170.                file. One possible explanation is that the documentation
  171.                file does not correctly describe the contents of the data
  172.                file it documents.  Another possibility is that two 
  173.                images are being overlaid when they do not match in theè
  174.                number of rows and columns each has (which they must).
  175.  
  176.  
  177.                                        3
  178.  
  179.  
  180.        17. Attempt to read beyond end of data file.
  181.  
  182.           -    this message arises under a different circumstance, but 
  183.                the interpretation is the same as the "Unexpected end of
  184.                file" message above.
  185.  
  186.        18. The [data type] data type is not supported by this module.
  187.  
  188.           -    the data type specified in the documentation file is not
  189.                supported by the module you are trying to use. This is an
  190.                unlikely message unless you are sharing data files with
  191.                someone who has a later version of IDRISI than you do.
  192.  
  193.        19.  The  [data type] vector data type is not supported  by  this 
  194.        module.
  195.  
  196.           -    data type in vector files refers to the identifiers (and
  197.                not the coordinate values which are always interpreted as
  198.                real numbers).  IDRISI recognizes that the identifiers 
  199.                can only be of type integer or real.
  200.  
  201.        20. The [file type] file type is not supported for vector files.
  202.  
  203.           -    only ASCII and simple binary files are supported for 
  204.                vector data.
  205.  
  206.        21. Classified values file must contain integer class data.
  207.  
  208.           -    the documentation file indicates that the number of 
  209.                classes is greater than zero (and thus that it is
  210.                classified), but that the file contains real numbers 
  211.                -- an impossibility.  If the data are raw unclassified
  212.                data, be sure that the number of classes is stated as 
  213.                zero (an indication that the data are raw values).
  214.  
  215.        22. Only integer attribute values files may contain a legend.
  216.  
  217.           -    the documentation file indicates that a legend is 
  218.                attached, but the data type is listed as real or string.
  219.                Only integer values files can contain a legend 
  220.                (logically).
  221.  
  222.  
  223.        10.4 Disk and Directory Errors
  224.         
  225.        23. Insufficient disk space for attempted operation.
  226.  
  227.           -    your data disk is full!
  228.  
  229.        24. Insufficient disk space for block transfer.
  230.  
  231.           -    although the cause is slightly different, the meaning is
  232.                identical to the one above -- your disk is full!è
  233.  
  234.                                        4
  235.  
  236.  
  237.        25. Data disk directory is full.
  238.  
  239.           -    the directory track of your data disk has no more room 
  240.                for file names.
  241.  
  242.        26. File disappeared. Has the data disk been removed?
  243.  
  244.           -    Have you have removed a disk while it was still being 
  245.                used?  This error message also tends to occur when there
  246.                is an internal problem in a module's file record keeping.
  247.                If you get this happening consistently, please notify 
  248.                the IDRISI bulletin-board system.
  249.  
  250.  
  251.        10.5 Data Processing Errors
  252.  
  253.  
  254.        27. Floating point overflow (number too large)
  255.  
  256.           -    it is possible (although unlikely) that an operation may
  257.                result in the generation of a number that is beyond your
  258.                computer's range.
  259.  
  260.        28. Division by zero attempted.
  261.  
  262.           -    this is unlikely to occur, but a division by zero leads 
  263.                to an infinite result -- an impossible operation!
  264.  
  265.        29. Square root of negative number attempted.
  266.  
  267.        30. Logarithm of zero or negative number attempted.
  268.  
  269.        31. Attempt to convert out-of-range real to integer.
  270.  
  271.           -    integers must fall within a range of -32768 to +32767. An
  272.                attempt has been made to convert a real number outside 
  273.                this range into an integer.
  274.  
  275.        32. Out of range value assigned to scalar.
  276.  
  277.           -    a value was expected to be either a byte value or an
  278.                integer and the value did not conform to the expected
  279.                range. Byte values must be positive within the range of 
  280.                0 - 255.  Integers may be positive or negative within the
  281.                range of -32768 to +32767.
  282.  
  283.  
  284.        10.6 System Errors
  285.  
  286.        33. IDRISI environment file missing.
  287.  
  288.           -    The file named IDRISI.ENV could not be found on the 
  289.                default drive.  Check that your default drive (the oneè
  290.                indicated by the operating system prompt) correctly
  291.                indicates the drive that contains the IDRISI program
  292.  
  293.                                        5
  294.  
  295.  
  296.                modules and the environment file. If the environment 
  297.                file is missing, copy it onto the disk with the IDRISI
  298.                program modules, and run ENVIRON to confirm that it is
  299.                correctly configured.
  300.  
  301.        34. The printer code file named IDRISI.PRN could not be found.
  302.  
  303.           -    the module you are using accesses a printer and the 
  304.                printer code file (IDRISI.PRN) could not be found. 
  305.                Review the INSTALLATION steps required to install a 
  306.                proper code file and redo that portion of the 
  307.                installation procedure again.
  308.  
  309.  
  310.        35.  Structural  error  exists  in the printer  code  file  named 
  311.        IDRISI.PRN
  312.  
  313.           -    review the INSTALLATION section on the creation of a
  314.                printer code file. The code file you are using has an 
  315.                error in its structure.
  316.  
  317.        In addition to the error messages listed above, there are two
  318.        messages that are unlikely to occur due to your own actions. 
  319.        These are unspecified system errors that may signal a problem 
  320.        in the program code. If one of these should occur, and if the
  321.        solution is not obvious, please notify the IDRISI bulletin-
  322.        board system.  You will notice that each records an error 
  323.        number and sometimes an "offset" (an indication of where the 
  324.        error occurred within the program).  When reporting an error,
  325.        indicate its type, the error number and the offset.
  326.  
  327.        36. IDRISI input/output system error [error number] [offset = ?]
  328.  
  329.           -    a system error associated with input or output to the 
  330.                disk, keyboard, printer or screen.  Check also that 
  331.                the environment file correctly records the proper disk
  332.                drive and data path.
  333.  
  334.        37. IDRISI runtime system error [error number] [offset = ?]
  335.  
  336.           -    a system error associated with some aspect of data
  337.                processing.
  338.  
  339.  
  340.  
  341.  
  342.  
  343.  
  344.  
  345.  
  346.  
  347.  
  348. è
  349.  
  350.  
  351.                                        6
  352.